package com.aspire.aimini.repository;

import com.aspire.aimini.model.entity.Tag;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;
import java.util.Map;

/**
 * 标签Repository接口
 *
 * @author wangguiyou
 * @date 2024-01-01
 * @description 标签数据访问层接口
 */
@Mapper
public interface TagRepository extends BaseMapper<Tag> {

    /**
     * 分页查询标签列表
     *
     * @param page      分页对象
     * @param category  标签分类
     * @param keyword   搜索关键词
     * @param isSystem  是否系统标签
     * @param status    状态
     * @param sortBy    排序字段
     * @param sortOrder 排序方向
     * @return 分页结果
     */
    IPage<Tag> selectTagPage(
            Page<Tag> page,
            @Param("category") String category,
            @Param("keyword") String keyword,
            @Param("isSystem") Boolean isSystem,
            @Param("status") Integer status,
            @Param("sortBy") String sortBy,
            @Param("sortOrder") String sortOrder);

    /**
     * 根据名称查询标签
     *
     * @param name 标签名称
     * @return 标签
     */
    Tag selectByName(@Param("name") String name);

    /**
     * 根据分类查询标签列表
     *
     * @param category 标签分类
     * @return 标签列表
     */
    List<Tag> selectByCategory(@Param("category") String category);

    /**
     * 增加标签使用次数
     *
     * @param id 标签ID
     */
    void incrementUseCount(@Param("id") Long id);

    /**
     * 批量增加标签使用次数
     *
     * @param ids 标签ID列表
     */
    void batchIncrementUseCount(@Param("ids") List<Long> ids);

    /**
     * 减少标签使用次数
     *
     * @param id 标签ID
     */
    void decrementUseCount(@Param("id") Long id);

    /**
     * 批量减少标签使用次数
     *
     * @param ids 标签ID列表
     */
    void batchDecrementUseCount(@Param("ids") List<Long> ids);

    /**
     * 查询热门标签
     *
     * @param limit 限制数量
     * @return 标签列表
     */
    List<Tag> selectPopularTags(@Param("limit") Integer limit);

    /**
     * 查询最近创建的标签
     *
     * @param limit 限制数量
     * @return 标签列表
     */
    List<Tag> selectRecentTags(@Param("limit") Integer limit);

    /**
     * 根据分类统计标签数量
     *
     * @return 统计结果
     */
    List<Map<String, Object>> countByCategory();

    /**
     * 查询未使用的标签
     *
     * @return 标签列表
     */
    List<Tag> selectUnusedTags();

    /**
     * 模糊搜索标签
     *
     * @param keyword 关键词
     * @param limit   限制数量
     * @return 标签列表
     */
    List<Tag> searchTags(@Param("keyword") String keyword, @Param("limit") Integer limit);

    /**
     * 查询系统标签
     *
     * @return 标签列表
     */
    List<Tag> selectSystemTags();

    /**
     * 查询用户自定义标签
     *
     * @return 标签列表
     */
    List<Tag> selectCustomTags();

    /**
     * 批量更新标签状态
     *
     * @param ids    标签ID列表
     * @param status 状态
     * @return 更新数量
     */
    int batchUpdateStatus(@Param("ids") List<Long> ids, @Param("status") Integer status);

    /**
     * 清理未使用的标签
     *
     * @param days 天数
     * @return 清理数量
     */
    int cleanUnusedTags(@Param("days") Integer days);
}